home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / (A)C / (A)C1.ADF / Utilities / New_utility / DMS.doc < prev    next >
Text File  |  1989-09-12  |  16KB  |  495 lines
  1. FILE: DMS.doc - AmigaDOS version 1.0 partial online documentation  -
  2.  11/11/90
  3.  
  4. *********************************************************************
  5.  
  6.                           The DISK-Masher
  7.                    Copyright (c) 1990 SDS Software
  8.  
  9.  
  10. *********************************************************************
  11.  
  12. What is it?
  13.  
  14.     The DISK-Masher (DMS) is a utility that allows users to compress
  15. and archive floppy disks. Version 1.0 requires at least 512k of
  16. memory, and AmigaDOS version 1.2 or later.
  17.  
  18. Why a disk archiver?
  19.     Many programs are available for archiving individual files and do
  20. a relatively good job. However DMS was created for the purpose of
  21. archiving whole disks.  It is useful for archiving non-filing system
  22. disks which cannot be done with standard file archivers, sending
  23. distribution disks, archivinglibrary collections, and many other
  24. uses. DMS takes much less time to put a disk back together than with
  25. a file archiver and is less wear and tear on your disk drives.
  26.  
  27. Why not use other disk archivers?
  28.     DMS has been tested against every other similar type programs and
  29. will provide faster execution, greater compression, more support
  30. features, and continuing user support.  Once you try DMS you won't be
  31. satisfied with anything else.  Among other things DMS provides:
  32.  
  33.     - Highly optimized compression routines offerring the utmost
  34.       in speed and compression.  4 different routines to choose from
  35.       to satisfy your needs.
  36.  
  37.     - The ability to read and write to or from any AmigaDOS device
  38.       conforming to the standard 80 tracks , 512 bytes per block , 11
  39.       blocks per track, 2 sides, Ex: DF0:, DF1:, RAD:, etc.
  40.  
  41.     - Extended Virus checking of the boot blocks. Other disk
  42.       archivers just show the boot block and do not check for
  43.       viruses, this is extremely stupid, most viruses do not come out
  44.       and say "Look here, I'm a virus!". Without actually checking
  45.       the boot block you're opening up a can of worms. Therefore DMS
  46.       currently checks for 15 known viruses and can automatically
  47.       install the disk. It is still Important that users monitor
  48.       their system periodically with a virus checker as there are
  49.       many types of viruses. 
  50.  
  51.     - Data Security.  DMS has the option to encrypt archives with a
  52.       user selected password for security.
  53.  
  54.  
  55. *********************************************************************
  56.  
  57.                     Command Line Options and Usage
  58.  
  59.   The general format for a DMS command is:
  60.  
  61.   DMS command file[.DMS] [OPTIONS ...]
  62.  
  63.   Everything in braces [] is optional. Everything else is required.
  64.  
  65.   file[.DMS] is a user specified filename.  The .DMS ending will
  66.   automatically be appended to the filename if you do not include it.
  67.   This is done to avoid confusion with other archiver formats.
  68.  
  69.  
  70. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  71.  
  72. 1.) READ
  73.  
  74.   This command will read and compress a disk. The basic usage for
  75. this command is:
  76.  
  77.   DMS Read file[.DMS] [FROM Dev:] [TEXT filetext] [CMODE mode] [LOW
  78. lowtrack] [HIGH hightrack] [NOVAL] [NOZERO] [ENCRYPT password]
  79. file[.DMS]
  80.  
  81.   - the output file which will contain the archived disk.
  82.  
  83. OPTIONS:
  84.  
  85.   FROM Dev:
  86.  
  87.   - Will read the disk from a different device. The default device is
  88. DF0: (internal drive). You may choose any device as long as it has 80
  89. tracks, 2 sides, 11 sectors/track, and 512 bytes per sector.
  90.     Examples: DF0:, DF1:, DF2:, DF3:, RAD:, FM0:, FF0:, etc.
  91.  
  92.   TEXT filetext
  93.  
  94.   - Causes DMS to read in the file 'filetext' and add it to the
  95.  archive. When the archive is extracted the text will be displayed
  96.  before writing the disk.  This is useful for identifying disks or
  97.  giving other information about the archive.  
  98.  
  99.   CMODE mode
  100.  
  101.   - Chooses the compression mode used.  Mode is a value from 0 to 4.
  102.     The default mode is 3 - medium compression.
  103.  
  104.     Available modes are:
  105.  
  106.       0 - No Compression               Very quick but no compression
  107.       1 - Simple Compression           Very quick with limited
  108.                                        compression
  109.       2 - Quick Compression            Quick with better compression
  110.       3 - Medium Compression (default) Good speed/compression ratio
  111.       4 - Deep Compression             Slowest with the greatest
  112.                                        compression
  113.  
  114.     Mode 3 was set as the default because it represents the best
  115.     size/speed combination. It is recommended that you use this mode
  116.     if you are planning to send archives via modem to many people.
  117.     Use mode 4 if you have an accelerator card in your machine or for
  118.     permanent archiving where you will only occasionally have to
  119.     extract the archive.
  120.  
  121.   LOW lowtrack
  122.  
  123.   - Specifies the starting track to read from. The default is track
  124.     0. Lowtrack must be a value from 0 to 79.
  125.  
  126.   HIGH hightrack
  127.  
  128.   - Specifies the ending track to stop at.  The default is track 79.
  129.     Hightrack must be a value from 0 to 79.
  130.  
  131.   NOVAL
  132.  
  133.   - Stops DMS from inhibiting the disk validator when reading the
  134.     disk.
  135.  
  136.   NOZERO
  137.  
  138.   - Normally DMS will read the AmigaDOS bitmap from the disk and
  139.     archive only sectors which are being used. If the disk is a non_
  140.     filing system disk or has a bad bitmap, DMS will automatically
  141.     archive the whole disk. In EXTREME cases DMS will make a wrong
  142.     assumption about the type of disk it is archiving. NOZERO will
  143.     cause DMS to archive the whole disk totally ignoring the disk
  144.     bitmap. Generally you will rarely if ever have to use this
  145.     option.
  146.  
  147.   ENCRPYT password
  148.  
  149.   - Causes DMS to encrypt the input from the disk using the password
  150.     supplied. 'password' is any alphanumeric word you desire.
  151.     Examples: Joe, Fred, ABC1234, ONLY-FOR-ME, etc.
  152.  
  153. EXAMPLES:
  154.  
  155.   DMS read disk1
  156.  
  157.   - Will compress a disk from drive DF0: using the default
  158.     compression mode and store the results in the file 'disk1.DMS'
  159.  
  160.   DMS read stuff.DMS lowtrack 20
  161.  
  162.   - Will compress only tracks 20 to 79 into file 'stuff.DMS'
  163.  
  164.   DMS read stuff lowtrack 40 hightrack 40
  165.  
  166.   - Will compress only track 40 into file 'stuff.DMS'
  167.  
  168.   DMS read stuff from df1: cmode 4 noval nozero text RAM:intro
  169.  
  170.   - Will compress a disk from drive DF1: using compression mode 4,
  171.     not inhibiting the disk validator, not using the disk bitmap and
  172.     adding the text from file 'RAM:intro' to the file 'stuff.DMS'
  173.  
  174.   DMS read stuff.DMS from RAD: encrypt JOESTUFF1
  175.  
  176.   - Will compress a disk from ram drive RAD: and encrypting the
  177.     output with the password 'JOESTUFF1' to file 'stuff.DMS'
  178.  
  179.   DMS read stuff.DMS text CON:0/0/640/200/window
  180.  
  181.   - Will compress a disk and allow you to quickly add text to the
  182.     archive. A console window will open up and you can then type any
  183.     text you want. To finish type CTRL \ to close the window and
  184.     continue.
  185.  
  186.  
  187. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  188.  
  189. 2.) WRITE
  190.  
  191.   This command will uncompress and write a disk. The basic usage for
  192. this command is:
  193.   DMS Write file[.DMS],,, [TO Dev:] [LOW lowtrack] [HIGH hightrack]
  194.           [NOVAL] [NOTEXT] [NOPAUSE] [DECRYPT password]
  195.  
  196.   file[.DMS],,,
  197.  
  198.   - One or more input files to be extracted. Standard AmigaDOS wild_
  199.     cards are supported.
  200.  
  201. OPTIONS:
  202.  
  203.   TO Dev:
  204.  
  205.   - Will write the output to device Dev: (the default is drive DF0:)
  206.     The device must follows the same rules as in the READ command.
  207.  
  208.   LOW lowtrack
  209.  
  210.   - Specifies the starting track to write from. Tracks before low_
  211.     track will be ignored.  Default is track 0.
  212.  
  213.   HIGH hightrack
  214.  
  215.   - Specifies the ending track to write from.  Tracks after hightrack
  216.     will be ignored. Default is track 79.
  217.  
  218.   NOVAL
  219.  
  220.   - Stops DMS from inhibiting the disk validator when writing a disk.
  221.  
  222.   NOTEXT
  223.  
  224.   - Causes DMS to ignore any text to be displayed from the archive.
  225.  
  226.   NOPAUSE
  227.  
  228.   - Stops DMS from pausing after displaying any text from the
  229.     archive.
  230.  
  231.   DECRPYT password
  232.  
  233.   - Causes DMS to decrypt the archive with the password 'password'.
  234.     This is only used if the archive was previously encrypted.
  235.     'password' must be the EXACT same one used when encrypting the
  236.     file otherwise the archive will not be processed correctly.
  237.  
  238. EXAMPLES:
  239.  
  240.   DMS write stuff
  241.  
  242.   - Will extract the archive stuff.DMS to drive DF0:
  243.  
  244.   DMS write part1 part2.dms TO DF2: NOTEXT
  245.  
  246.   - Will extract the archives part1.DMS and part2.DMS to drive DF2: ,
  247.     ignoring any banner text in the archives
  248.  
  249.  
  250. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  251.  
  252. 3.) REPACK
  253.  
  254.   This command allows you to recompress an older DMS archive. It can
  255. also be used as a simple split utility. The basic usage for this
  256. command is:
  257.  
  258.   DMS Repack file[.DMS] [TO file2[.DMS]] [LOW lowtrack] [HIGH
  259.  hightrack]
  260.                         [CMODE mode]
  261.  
  262.   file[.DMS]
  263.  
  264.   - The input file to be recompressed.
  265.  
  266. OPTIONS:
  267.  
  268.   TO file2[.DMS]
  269.  
  270.   - Causes DMS to store the results in file2.DMS, otherwise the
  271.     results are automatically stored in a file TEMP.DMS
  272.  
  273.   LOW lowtrack
  274.  
  275.   - Specifies lowtrack to start recompression. Tracks before lowtrack
  276.     will be ignored.  Default is track 0.
  277.  
  278.   HIGH hightrack
  279.  
  280.   - Specifies hightrack to end recompression.  Tracks after hightrack
  281.     will be ignored.  Default is track 79.
  282.  
  283.   CMODE mode
  284.  
  285.   - Chooses the compression mode to use. Same as in the READ command.
  286.  
  287. EXAMPLES:
  288.  
  289.   DMS repack stuff low 20 high 40 cmode 1
  290.  
  291.   - Will extract tracks 20 through 40 from the archive stuff.DMS ,
  292.     recompress them using compression mode 1 (Simple) and store the
  293.     results in the file TEMP.DMS .
  294.  
  295.   DMS repack old.dms TO new.dms
  296.  
  297.   - Will recompress the archive old.DMS using the default compression
  298.     mode and store the results in the file new.DMS
  299.  
  300.  
  301. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  302.  
  303. 4.) VIEW
  304.  
  305.   This command will view information about a DMS archive. The basic
  306. usage for this command is:
  307.  
  308.   DMS View file[.DMS],,, [FULL]
  309.  
  310.   file[.DMS],,,
  311.  
  312.   - One or more input files to be viewed. Standard AmigaDOS wildcards
  313.     are supported.
  314.  
  315. OPTIONS:
  316.  
  317.   FULL
  318.  
  319.   - Causes DMS to display information about every track in the
  320.     archive. Otherwise only the information header will be displayed.
  321.  
  322. EXAMPLES:
  323.  
  324.   DMS view file1 part#? full
  325.  
  326.   - Will display full information about the archives file1.DMS and
  327.     the files part#?.DMS
  328.  
  329.  
  330. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  331.  
  332. 5.) TEST
  333.  
  334.   This command will test the integrity of a DMS archive. The basic
  335. usage for this command is:
  336.  
  337.   DMS Test file[.DMS],,,
  338.  
  339.   file[.DMS],,,
  340.  
  341.   - One or more input files to be tested. Standard AmigaDOS wildcards
  342.     are supported.
  343.  
  344. EXAMPLES:
  345.  
  346.   DMS test file1 part#?
  347.  
  348.   - Will test the archives file1.DMS and the files part#?.DMS
  349.  
  350.  
  351. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  352.  
  353. 6.) TEXT
  354.  
  355.   This command will display any banner text in a DMS archive. This is
  356. used to quickly find out information about an archive without having
  357. to extract it.  The basic usage for this command is:
  358.  
  359.   DMS Text file[.DMS],,,
  360.  
  361.   file[.DMS],,,
  362.  
  363.   - One or more input files to display text. Standard AmigaDOS
  364.     wildcards are supported.
  365.  
  366. EXAMPLES:
  367.  
  368.   DMS text file1 part#?
  369.  
  370.   - Will display any banner text from the archives file1.DMS and the
  371. files part#?.DMS
  372.  
  373. *********************************************************************
  374.  
  375.                        General Information
  376.  
  377.     DMS has been over a year in the making,  the compression routines
  378. are proprietary and we have taken great care to make sure they are
  379. the very best. There is no other program even close to DMS as far as
  380. versatility, performance, and ease of use. We have been beta testing
  381. for over 4 months to make sure every little detail is taken care of.
  382. We urge users to register with us so that we continue to provide the
  383. best and continuing support of the product.
  384.  
  385.     This program is NOT Shareware or Public Domain, it is Copyright
  386. 1990 by SDS Software. We have taken a different approach in
  387. distributing this program than most people. There will always be a
  388. version of DMS available to the general public free of charge.
  389. However, we are offerring as an incentive to register, many other
  390. programs that will not be available to the general public. We feel
  391. that you should get what you pay for and pay for what you use.
  392. Therefore if you seldom use DMS then the public version is fine for
  393. you and we thank you for using it. If you use DMS on a regular basis
  394. you are asked to register with SDS Software.  Registering will enable
  395. you to receive quickly future updates and other programs not
  396. available to the general public. Updates will be provided to users on
  397. a first-come, first-serve basis before public releases. Many of our
  398. colleagues have given up on the Amiga community and have decided to
  399. pursue the large PC/CLONE market. We have faith in our users and
  400. believe that above all, good software comes through and will be
  401. rewarded. Please make sure that this program remains the very best by
  402. registering with us.
  403.  
  404.     There are 2 levels of registration to choose from:
  405.  
  406.     Regular:
  407.     -------
  408.  
  409.         For $30 you will be mailed a complete hard-copy manual and
  410.  the latest version of DMS on disk. You will also receive an account
  411.  on the SDS Software bulletin board system and be able to download
  412.  via modem the latest versions free of charge. If you do not wish or
  413.  have the capability to call the BBS, you can at any time send your
  414.  disk with an SASE and we will copy the latest versions and mail it
  415.  back to you. It also gives you an unlimited Upload/Download ratio on
  416.  the BBS for one year. Along with the CLI/Shell version of DMS you
  417.  will also receive when available:
  418.  
  419.         DMSPro - an advanced version of DMS with faster routines and
  420.                  the capability to archive Amax, Mac, MS-DOS, and
  421.                  Atari-ST format disks.
  422.  
  423.         DMSWin - an Intuition version of DMS with full windowing,
  424.                  gadgets and graphical display.
  425.  
  426.     Professional:
  427.     ------------
  428.  
  429.         For $50 you will receive the same privileges as above but
  430.  will also receive when available:
  431.  
  432.         DMS030 - a 68020/030 version of DMS with faster routines
  433.         optimized for those CPU's
  434.  
  435.         DMSMem - a mega-memory version of DMS with greater
  436.         compression and faster routines.
  437.  
  438.         Convert - a Warp-to-DMS converter to convert old .WRP files
  439.         to the new .DMS format.
  440.  
  441.         Convert.EXE - an MS-DOS version of the Warp-to-DMS converter
  442.         for people storing files on MS-DOS machines.
  443.  
  444.         SelfDisk - a utility to create Self-Extracting disk archives.
  445.         It will take an existing DMS archive and change it to be an
  446.         executable file that anybody can use to extract without
  447.         having DMS.
  448.  
  449.         You will also receive MS-DOS utilities to test, and view
  450.         archives. These are particularly useful to people running
  451.         BBS's that carry a large volume of files.
  452.  
  453.  
  454.     Send a Check or Money Order for the amount of registration you
  455.  choose, along with your full name, address, phone number, and
  456.  computer configuration to:
  457.  
  458.     SDS Software.
  459.     Suite 126
  460.     4885-A Mcknight Rd.
  461.     Pittsburgh, PA  15237
  462.  
  463.  
  464.     It is our sincere hope that we can continue to service the Amiga
  465. community with new and innovative programs. Please allow us to do so
  466. by supporting our products which you use.  Thank you.
  467.  
  468.     If you have any suggestions, complaints, questions, or bug
  469. reports, please write to the above address and be sure to include
  470. your full name, address, phone number, and computer configuration.
  471.  
  472.     The DISK-Masher (DMS) is Copyright (c) 1990 by SDS Software.
  473. It is NOT Public Domain.  The CLI/Shell GENERIC version is freely
  474. distributable provided the following rules:
  475.  
  476.     1.  No charge excepting reasonable media costs may be charged.
  477.  
  478.     2.  The program and documentation may not be modified in any way.
  479.  
  480.     3.  Only the self-extracting archive DMS100.EXE may be
  481.         distributed
  482.  
  483.     SDS Software will be in no way liable for damages, incidental, or
  484. consequential, arising from the use or misuse of The DISK-Masher or
  485. for any other claim by any other party. Use this program at your own
  486. risk.
  487.  
  488. *********************************************************************
  489.  
  490.     Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.
  491.     MS-DOS is a trademark of Microsoft.
  492.     Atari ST is a trademark of Atari Computers.
  493.     Macintosh is a trademark of Apple Computers.
  494.     Amax is a trademark of Readysoft, Inc.
  495.